home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / prgmming / gxldemo / readme.txt < prev    next >
Encoding:
Text File  |  1994-09-24  |  13.8 KB  |  342 lines
  1. September 24, 1994
  2.  
  3. The GXL Graphical Interface Library version 2.1
  4. Copyright (C) 1992-1995 Kevin Hise, Hise Development.  All rights reserved.
  5.  
  6.  
  7. Introduction:
  8. -------------
  9.  
  10.      The GXL graphical interface library provides the C++ programmer
  11. with software tools to create a powerful and flexible graphics
  12. interface.  The library is built using an event driven architecture
  13. which allows program actions to be queued and processed as events.
  14. This approach allows an application to cooperatively share processor
  15. time between user-input polling, printing, and for example, updating a
  16. clock on the display.  It also has the added advantage of allowing
  17. program functions to be initiated or handled generically.  This means
  18. that your application doesn't need to concern itself with whether a
  19. mouse button was clicked or a touch-screen was pressed, it just
  20. responds to the event sent by an object selected on the screen.
  21.      GXL is intended to serve as the foundation for a graphical
  22. application by providing the neccessary services to manage events and
  23. displayed objects.  In addition to ready-to-use objects, simple base
  24. classes are provided from which customized objects can be created.
  25.  
  26.  
  27. The Demonstration Program:
  28. --------------------------
  29.  
  30.      This shows many of the ready-to-use objects you can build an
  31. application with:
  32.  
  33. - 3D 'chiseled-look' buttons and icons.
  34. - Windows that can be re-positioned (click-and-drag on title bar).
  35. - A desktop or canvas customizer.
  36. - Text with different fonts and justifcation.
  37. - Blinking text.
  38. - Analog and digital clocks.
  39. - Scroll bars and List boxes.
  40. - Text input fields.
  41.  
  42.      Some sample applications are also shown:
  43.  
  44. - A screen saver.
  45. - A simple Point-Of-Sale interface.
  46.  
  47.  
  48. Running the Demo:
  49. -----------------
  50.  
  51. System Requirements:
  52.  
  53. - An IBM or compatible computer.
  54. - MS-DOS 3.x or later.
  55. - At least 384kb of free RAM.
  56. - A VGA display card and monitor.
  57. - A Microsoft or compatible mouse (driver).
  58.  
  59. Note: You may also run the demo as a full-screen DOS application in
  60.       OS/2 2.x or MS-Windows 3.x.
  61.  
  62.      If you've downloaded the demo from a BBS, you must un-zip the
  63. executable, driver and font files (since your reading this, we can
  64. assume you've already done so!)  If the demo program is located on a
  65. floppy diskette, it can be started directly from that disk, or copied
  66. to your hard disk.  To run the the demo from the floppy disk:
  67.  
  68.      From a DOS prompt type in: 'A:DEMO' and press enter (note: use
  69. 'B:DEMO' if you inserted the disk in drive B).
  70.  
  71.      To run the demo from your hard disk:
  72.  
  73.      Copy the contents of the demo diskette into a temporary directory
  74. on your hard disk.  Change to that directory and type in 'DEMO' and
  75. press enter.
  76.  
  77.      When the demo loads it should display the MetaWINDOW graphics
  78. hardware selection screen.  Just press ENTER to use the selected display
  79. mode.  If you're familiar with your graphics card chip-set, you can
  80. select a higher (or lower) resolution mode.  It is not recommended that
  81. you run the demo on a lower resolution than VGA mode 12h (640x480x16
  82. colors.)  When the demo main screen appears a window with a few menu
  83. buttons should be visible.  The mouse pointer should also be present on
  84. the screen.  The demo requires a mouse.
  85.  
  86.  
  87. A tour of the demo:
  88. -------------------
  89.  
  90.     From the main window, these options are available:
  91.  
  92. Exit:       End the demo.  Selecting this button closes all windows and
  93.             returns you to a DOS prompt.
  94.  
  95. Windows:    A simple dialog window containing a border, title bar,
  96.             dialog text and a close button.
  97.  
  98. Buttons:    Sample button and icon types including vertical and
  99.             horizontal scroll bar attatched to the window's edge.
  100.             Moving the scroll bar updates the X and Y position text.
  101.  
  102. Canvas:     Allows you to change the desktop color and pattern.  This
  103.             window modifies the settings in the canvas object attatched
  104.             to the the system and then tells the canvas to re-draw
  105.             itself.  A canvas can be of any type (solid color, pattern or
  106.             a programmer defined type).
  107.  
  108. Text:       Sample text fonts and justification, including a blinking
  109.             text object.  The contents of a text object can be changed at
  110.             any time without concern for the display (the text object
  111.             knows how to display itself).  Blinking text is created by
  112.             simply setting an attribute flag.  When blinking text is
  113.             partialy obscured by an overlapped window, it continues to
  114.             blink showing only the visible portion.  All objects which
  115.             contain text can use a default or programmer defined font.
  116.             (Font support is provided by the DISPLAY_DEVVICE
  117.             implementation.  The BGI using .CHR files and MetaWINDOW
  118.             uses bit-mapped .FNT files.)
  119.  
  120. Clocks:     Using GL2's event driven scheme, it becomes easy to create
  121.             objects that perform functions on a timely basis.  A
  122.             graphical clock is one object that demonstrates this.  The
  123.             clock object has many options which are available to the
  124.             programmer:
  125.  
  126.             - Analog or Digital format.
  127.             - Portrait or Lanscape orientation (date on left or bottom).
  128.             - Display seconds (or second hand.)
  129.             - 12 or 24 hour formats.
  130.             - Show date and day.
  131.             - Color scheme and font.
  132.  
  133. List:       vertical list box with scroll bar.
  134.  
  135. Input:      window with some data entry fields and blinking cursor.
  136.  
  137. Pick File:  file selection dialog.
  138.  
  139. POS:        simple point-of-sale order entry screen.
  140.  
  141.  
  142. Some hints for using the interface during the demo:
  143. ---------------------------------------------------
  144.  
  145. - In addition to selecting the Exit button, you may also press the Esc
  146. key to end the demo and return to DOS.
  147.  
  148. - Objects are selected by positioning the mouse pointer over them and
  149. clicking the left mouse button.
  150.  
  151. - You can reposition a window by clicking and dragging it's title bar
  152. (similar to Windows and OS/2) with the left mouse button.
  153.  
  154. - If you've selected a sample window, you can create another one by
  155. selecting the same option from the main window.  This becomes
  156. interesting after selecting the clock option several times.
  157.  
  158. - Windows cannot be re-sized or positioned off the screen (not very
  159. useful in a touch-screen interface application).
  160.  
  161. - The screen-saver feature will 'take over' after about 60 seconds of
  162. user inactivity.  It displays a star field similiar to MS-Windows.
  163. Moving the mouse or pressing a key will restore the display.
  164.  
  165.  
  166. GXL Library Features:
  167. ---------------------
  168.  
  169. - GXL is written entirely in C++, making it portable to any C++
  170. compiler that supports templates.
  171.  
  172. - Display hardware and software (3rd party graphics library)
  173. independence via a DISPLAY_DEVICE class.  This allows you to employ
  174. your own graphics routines, use a 3rd party library, or the graphics
  175. library included with your compiler.
  176.  
  177. - Objects overlapped by a window can write to the screen without
  178. disturbing the overlapping window (ie: blinking text or clock hands).
  179.  
  180. - Objects are drawn directly on the screen - no 'virtual screen' to
  181. slow painting.
  182.  
  183. - Complete programmer control over size, font, color scheme and
  184. position of objects.
  185.  
  186. - Buttons, scroll bars, etc. can use a common 'system size' which
  187. determines their width and height.  This value can be set at program
  188. start-up.
  189.  
  190. - Supports unlimited number of windows active at any time (limited only
  191. by available memory.)
  192.  
  193. - Allows windows to be moved and position on the "stack" changed.
  194.  
  195. - Updates the display when a window is added, moved, or removed by
  196. drawing only the exposed regions.
  197.  
  198.  
  199. Included Library Objects:
  200. -------------------------
  201.  
  202. Event Devices:
  203.  
  204. - BIOS keyboard input device.
  205. - Microsoft mouse input device.
  206. - Elographics touch screen input device.
  207. - Programmable event timer.
  208. - Screen saver timer.
  209.  
  210. Window Objects:
  211.  
  212. - Windows (supporting border, title bar, background, etc.)
  213. - Groups (an object collection similiar to a window).
  214. - Border (window borders).
  215. - Canvas (window and desktop backgrounds).
  216. - 3-D buttons with text and icons.
  217. - Icons with text.
  218. - Scroll bars (vertical or horizontal).
  219. - Vertical list box.
  220. - Text (blinking, selectable fonts)
  221. - Input fields with blinking cursor.
  222.  
  223. Bonus Window Objects:
  224.  
  225. - Analog and Digital Clocks with Date and Day display.
  226. - Starfield screen saver window.
  227.  
  228.  
  229. Additional support:
  230. -------------------
  231.  
  232. - Object storage and retrieval.
  233.  
  234.  
  235. Compiler:
  236. ---------
  237.  
  238.      GXL was developed with the Borland 3.1 compiler and includes
  239. DISPLAY_DEVICE support for the BGI and MetaWINDOW.  Out-of-the-box
  240. support for Watcom and Microsoft's C++ compilers will be available in
  241. the future.  If you need to port the library, your compiler should
  242. support templates.
  243.     Currently, GXL is shipped with a library compiled with Borland's
  244. 4.02 compiler.  Support is also provided for VROOM, or overlays.
  245.     Support for the DOS PowerPack (both DMPI16 and DPMI32) will be
  246. available soon.
  247.  
  248.  
  249. Service and Support:
  250. --------------------
  251.  
  252.      Technical support is provided 9 to 5 (Pacific time) Monday thru
  253. Friday via our toll number.  There is no fee for support and you become
  254. eligible when your order is recieved.  Development assistance and
  255. programming services are also available.
  256.  
  257.  
  258. Library QA:
  259. -----------
  260.  
  261.      We use (and highly recommend) Bounds Checker to locate and
  262. squash memory bugs before shipping.
  263.  
  264.  
  265. About GXL:
  266. ----------
  267.  
  268.      Now in it's second version, GXL is a complete re-write of the
  269. original "GL" which was designed as an interface library for
  270. Point-Of-Sale applications.  GL was used to develop several kiosk products.  
  271. Now, GXL is currently being used in public information kiosk applications 
  272. by Hise Development.
  273.  
  274.  
  275. NOTE: Be sure to ask about our ready to use Video Brochure product called
  276.       Vid-Master 2000 !!
  277.       Kiosk and Demo disk Ready!!
  278.  
  279.  
  280. Copyright and Trademark Acknowledgement:
  281. ----------------------------------------
  282.  
  283. MetaWINDOW is a product of Metagraphics Software Corporation.
  284. BGI (Borland-Graphics-Interface) is a product of Borland International.
  285. OS/2 is a product of International Business Machines.
  286. MS Windows is product of Microsoft Corporation.
  287. Bounds Checker is a product of Nu-Mega Technologies, Inc.
  288. Inside Advantage is a product of Parlet Data Systems.
  289. GL, GXL and Vid-Master 2000 are products of Kevin Hise and Hise Development.
  290.  
  291.  
  292. +=====================================================================+
  293. |                                                                     |
  294. |                        Ordering Information:                        |
  295. |                                                                     |
  296. +---------------------------------------------------------------------+
  297. | GXL Graphical Interface Library with source w/examples |            |
  298. |   and 140+ Page Manual!                                |            | 
  299. |                                                        |            |
  300. |   Send me ______ copies at $79.95 (US Funds Only) each |            |
  301. |                                                        |            |
  302. |---------------------------------------------------------------------|
  303. | GXL Graphical Interface Library DPMI 16 and DPMI 32    |            |
  304. |   (Protected Mode) with source w/examples              |            |
  305. |   and 140+ Page Manual!                                |            |         |            |
  306. |                                                        |            |
  307. |   Send me ______ copies at $124.95 (US Funds Only) each|            |
  308. |                                                        |            |
  309. |---------------------------------------------------------------------|
  310. | [ ] UPS ground              5.00 |                     |            |
  311. |----------------------------------|                     |            |
  312. | [ ] UPS Blue 2nd-Day-Air   10.00 |                     |            |
  313. |----------------------------------|                     |            |
  314. | [ ] UPS Red Next-Day-Air   15.00 |                     |            |
  315. |---------------------------------------------------------------------|
  316. |         Check shipping method above, place amount here |            |
  317. |---------------------------------------------------------------------|
  318. |                      CA residents add 7.25 % sales tax |            |
  319. |---------------------------------------------------------------------|
  320. | [ ]                                  COD charges $4.75 |            |
  321. |=====================================================================|
  322. |                                                        |            |
  323. |                                                 Total: |            |
  324. |                                                        |            |
  325. +=====================================================================+
  326. |                                                                     |
  327. |                                                                     |
  328. |                 Phone, mail or fax your order to:                   |
  329. |                                                                     |
  330. |                      GeNT Computer Services                         |
  331. |                        Attn: Brian A. George                        |
  332. |                      114-C  S. Gemstone Ave.                        |
  333. |                       Ridgecrest, CA 93555                          |
  334. |                                                                     |
  335. |               Voice: 619-384-2847  Fax: 619-371-1054                |
  336. |                                                                     |
  337. |                                                                     |
  338. +=====================================================================+
  339.  
  340.  
  341.  
  342.